package com.aims.server.service;

import com.aims.api.entity.User;
import com.aims.common.model.PageResult;

import java.io.Serializable;
import java.util.Collection;
import java.util.List;

/**
 * 用户服务接口
 *
 * <p>依赖 DAO：UserMapper</p>
 *
 * @author Generator
 * @since 2025-10-22
 */
public interface UserService {

    /**
     * 创建用户
     *
     * @param user 用户对象
     * @return 用户ID
     */
    Long create(User user);

    /**
     * 根据ID更新用户
     *
     * @param user 用户对象
     * @return 影响行数
     */
    int updateById(User user);

    /**
     * 根据ID删除用户
     *
     * @param id 用户ID
     * @return 影响行数
     */
    int deleteById(Serializable id);

    /**
     * 根据ID查询用户
     *
     * @param id 用户ID
     * @return 用户对象，不存在返回 null
     */
    User getById(Serializable id);

    /**
     * 查询所有用户
     *
     * @return 用户列表
     */
    List<User> listAll();

    /**
     * 统计用户总数
     *
     * @return 用户总数
     */
    long count();

    /**
     * 分页查询用户
     *
     * @param pageNo   页码（从1开始）
     * @param pageSize 每页大小
     * @return 分页结果
     */
    PageResult<User> page(int pageNo, int pageSize);
}